Skip to content

docs: rework documentation - #12

Merged
mikehardy merged 2 commits into
mainfrom
chore/docs-rework
Oct 22, 2026
Merged

mikehardy merged 2 commits into
mainfrom
chore/docs-rework

Conversation

@alexdukeinvertase

@alexdukeinvertase alexdukeinvertase commented Oct 21, 2026 •

Copy link
Copy Markdown
Member

Summary

Docs IA and voice pass so people (and agents) can install coverage without re-learning the product on every page. The left nav teaches Coverage → Install (pick a path) → Integrations / Troubleshooting; Reference holds CLI and config.

Preview: https://docs.page/invertase/react-native-coverage~12

What changed

  • “Pattern C” → “dedicated test app” — same rule (dedicated harness / e2e app only, never the shipping app). Old /pattern-c and /test-app redirect to Coverage → Dedicated test app. AGENTS.md, CONTRIBUTING.md, and Releasing use the new name.

  • Agent paste is one short line (identical on Overview, Coding agents, and the README PR):

    Read https://docs.page/invertase/react-native-coverage/app-developers.md, and set up react-native-coverage in this project.

    Setup detail stays on docs.page; constraints / exit codes stay on Coding agents and the install guides.

  • Nav / IA — Overview is a router (cards). Coverage replaces Why + Pattern C. Install: App developers / Library maintainers / Coding agents. Reference tab = CLI / config lookup. Troubleshooting stays on the Documentation tab.

  • Redirects — /why, /pattern-c, /test-app, /cli, /config, /integration/e2e-timing keep working.

  • README — deep install / proof stays on the docs site. Front door is a separate README-only PR.

Path / area Change Why
docs.json Documentation vs Reference tabs; Introduction → Install → Integrations → Troubleshooting; redirects; header keeps GitHub / Codecov Left nav should teach then install; lookup stays on Reference; old URLs still work
docs/index.mdx Overview as router: warning, agent one-liner, install cards Overview routes; it should not re-teach the product
docs/coverage.mdx New — measures, pipeline, dedicated test app, harness proof; RNFB Codecov gap (65.9% / 0.0%) on this page only One explanation page replaces Why + Pattern C
docs/why.mdx, docs/pattern-c.mdx Removed → redirects to /coverage (+ #dedicated-test-app) Content lives on Coverage
docs/app-developers.mdx Primary install; flush→pull→assert; devDependencies / autolinking Warning; iOS --device / --derived-data Shared install recipe for humans and agents
docs/library-maintainers.mdx Defers install to app-developers; dedicated-test-app wording; Codecov / JaCoCo labels Avoid a second install essay; keep maintainer-specific notes
docs/agents.mdx Coding agents: short one-liner; rules / exit codes kept Paste points at docs.page; constraints stay here
docs/integration/* Voice/structure; new codecov.mdx; e2e-timing.mdx removed (absorbed into app-developers) Upload/flags need a home; timing isn’t a separate page
docs/cli.mdx, docs/config.mdx Removed → /reference/cli, /reference/config Lookup belongs under Reference
docs/reference/{index,cli,config}.mdx New Reference lookup Documentation tab stays about understanding and install
docs/troubleshooting/empty-coverage.mdx New Empty-coverage fixes need one starting place
docs/releasing.mdx Pattern C / mode-c scrubbed Same vocabulary as docs.page
AGENTS.md, CONTRIBUTING.md Dedicated test app + docs path links In-repo copy must match docs.page

Test plan

Verdict: PASS — plan A/B/C plus locked outcomes (Project Context docs/test-plan-results.md). Re-verify redirects and content on this PR’s docs.page preview.

Step Result
RNFB gap on Coverage only (not README) PASS
Short identical agent paste (Overview + Agents) PASS
Pattern C → dedicated test app (AGENTS / CONTRIBUTING / Releasing) PASS
App developers devDependencies Warning + iOS --device / --derived-data PASS
Overview cards-as-router; Codecov flag sets + JaCoCo path notes labeled PASS
Inventory: Why/Pattern C deleted; CLI/config → Reference; e2e-timing → app-developers; new Coverage / Codecov / troubleshooting / reference PASS
Claim map: load-bearing facts relocated or intentional drop called out PASS
Install spot-check (App developers, Android, iOS, JS, CI Appium, Agents) PASS
Redirects 307 → correct targets; key pages + .md / llms.txt 200 PASS
Codecov assets 200 PASS
Overview routes; Coverage replaces Why + Pattern C; agents/maintainers defer install PASS
CLI/config under Reference; Troubleshooting on Documentation tab PASS

This was referenced Oct 21, 2026
@alexdukeinvertase alexdukeinvertase changed the title docs: rework documentation IA (reopen) docs: rework documentation IA Oct 21, 2026
@alexdukeinvertase alexdukeinvertase changed the title docs: rework documentation IA docs: rework documentation Oct 21, 2026
@alexdukeinvertase alexdukeinvertase changed the title docs: rework documentation docs: rework documentation IA Oct 21, 2026
@alexdukeinvertase alexdukeinvertase changed the title docs: rework documentation IA docs: rework documentation Oct 21, 2026
@alexdukeinvertase
alexdukeinvertase marked this pull request as ready for review October 22, 2026 09:19
alexdukeinvertase and others added 2 commits October 22, 2026 12:32
Co-authored-by: Cursor <cursoragent@cursor.com>
Bring PR #8 docs rework onto main and apply locked reopen picks:
restore RNFB Codecov gap on Coverage only; scrub Pattern C from
AGENTS/CONTRIBUTING/releasing; restore App developers Warning and
required iOS CLI flags; align Codecov flag sets and JaCoCo paths.
@codecov

codecov Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 59.54%. Comparing base (75c98ef) to head (e798b1d).

Additional details and impacted files
@@            Coverage Diff            @@
##               main      #12   +/-   ##
=========================================
  Coverage     59.54%   59.54%           
  Complexity       15       15           
=========================================
  Files            22       22           
  Lines          1048     1048           
  Branches        239      239           
=========================================
  Hits            624      624           
  Misses          352      352           
  Partials         72       72           
Flag Coverage Δ
e2e-android 81.70% <ø> (ø)
e2e-ios-dynamic 90.62% <ø> (ø)
e2e-ios-static 63.07% <ø> (ø)
unit-js 54.08% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@mikehardy mikehardy left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also looks great, clicked through the docs.page live PR view and LGTM

@mikehardy
mikehardy merged commit 5a94ff1 into main Oct 22, 2026
10 checks passed
@mikehardy
mikehardy deleted the chore/docs-rework branch October 22, 2026 20:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants